sound object
This method will close any sound associated with the object.
bool close()
Parameters:
None.
Return value:
true on success, false on failure.
Remarks:
Closing a sound is useful when you want to release the current sound memory that is associated with the object in order to save resources, while still keeping the object alive for future use. This method is executed automatically when a sound object is destroyed, so you need not worry about calling it to clean up after yourself at the end of your script for example. This method is also executed if you call either the load or stream method on a sound object that already has a sound associated with it.
Example:
// Load a sound into memory, play it and close it.
void main()
{
sound test;
test.load("c:\\windows\\media\\ding.wav");
test.play_wait();
test.close();
}